言語ローカライズ

概要

Algonomy 製品は、製品詳細、カテゴリ名、および戦略メッセージをローカライズできる多言語サイトをサポートしています。顧客があなたのサイトを訪問すると、ページ上のインスツルメンテーションによって地域が提供され、その地域に応じた言語が定義されます。

ローカライズを使用することで、ユーザーは複数の言語をサイトで使用し、ページ上のインスツルメンテーションに基づいて、異なる言語で戦略メッセージ、カテゴリ、および製品の詳細を顧客に表示することが可能になります。

地域のサポートには、リージョンフィードと、すべてのページで地域のインスツルメンテーションが必要です。言語は、regionで設定された地域フィードファイルから判断されます。

言語

言語を使用するには、使用したい言語ごとに1つの地域を定義する必要があります。同じ物理的な地域に複数の地域を設定することも可能です。

たとえば、スイスという国を3つの地域と3つの言語で設定することができます：

地域ID	言語タグ
スイス - フランス語	ch-FR
スイス - ドイツ語	ch-DE
スイス - イタリア語	ch-IT

選択された言語によって、レコメンデーションで表示されるローカライズされた製品属性のセットが決まります。

地域と言語は密接に関連しており、地域フィード内の別々のファイルで設定されます：

region_full.txt: 各地域の設定。地域ごとの言語指定を含む
localized_product.txt: 製品のローカライズ
localized_category.txt: カテゴリのローカライズ
product_region_full_sitename.txt: 製品の地域情報（このファイルにはローカライズは含まれません）

どのファイルが必要かは、地域と言語の設定方法によって異なります。

言語パラメーター

recsForPlacement API を活用するサイト:

特定の言語を呼び出すには、以下のパラメーターを使用します：

'lang='

これは「言語」を意味します
例：lang=en-US

'flo='

これは「ロケールを強制する」という意味です
例：flo=it-IT

以下のパラメーターは無効であり、使用しても期待した結果は得られません：

'language='

p13n を活用するサイト:

特定の言語を呼び出すには、以下のメソッドを使用します：

R3_COMMON.forceLocale('xx_XX')

例：R3_COMMON.forceLocale('it-IT')

R3_COMMON.setLanguage('xx')

例：R3_COMMON.setLanguage('it')

Note: 製品名やカテゴリ名のローカライズが地域やロケールに対して提供されていない場合、その値を null として送信しないでください。null 値はカタログの公開処理で問題を引き起こすため、そのレコード自体を送信しないことが推奨されます。

例

複数の地域、それぞれに異なる言語

スカンジナビアで製品を販売している企業は、3 つの地域（通貨別）と 3 つの言語を持つことができます。

地域ID	言語タグ
スウェーデン	sv-SE
ノルウェー	dk-DK
フィンランド	fi-FI

このサイトでは、localized_product.txt と localized_category.txt に加え、region_full.txt および product_region_full_sitename.txt が必要です。

複数の物理地域、同一の言語

フランス、ベルギー、ルクセンブルクで販売している企業は、3 つの地域と 1 つの言語を持つことができます。価格と在庫は異なる可能性がありますが、言語は同じです。

地域ID	言語タグ
フランス	fr-FR
ベルギー	fr-FR
ルクセンブルク	fr-FR

このサイトでは localized_product.txt や localized_category.txt は不要ですが、価格と在庫をカバーするために region_full.txt と product_region_full_sitename.txt が必要です。

1 つの物理地域で複数言語

スイスにある企業は、サイトを複数の言語で提供できます。すべての価格はスイスフラン建てであるため、価格と在庫情報は異なる言語間で共有できます。したがって、以下の例では「スイス」地域に対し「ドイツ語」がデフォルト言語となります。

地域ID	言語タグ
スイス	ch-DE

推奨リクエスト内では、recsForPlacements における 'lang' パラメーター、または p13n.js の R3_COMMON.setLanguage('xx') を使用することで言語を上書きできます。同様に、スイスからフランス語で訪問している購買者には、地域IDは「スイス」、言語は「フランス語」となります。

このサイトでは、localized_product.txt と localized_category.txt が必要です。また現時点のプロダクト仕様では、region_full.txt と product_region_full_sitename.txt も必要になります。

ローカライズされた商品属性

以下のプロダクト属性は、リージョンフィード内でローカライズ可能です：

商品名
商品説明
リンクURL
画像URL
カテゴリ名

ストラテジーメッセージ

フィード内で設定された各言語セットに対して、ローカライズされたストラテジーメッセージを追加できます。正しい地域が設定されていれば、ローカライズされたメッセージは自動的に表示されます。